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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp) . 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3 GPP and ETSI identities can be found under 
http://webapp.etsi.org/key/queryform. asp . 
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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part of a TS-family covering the 3^^ Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.121: Advanced Alarm Management (AAM) Integration Reference Point (IRP): Requirements. 

32.122: Advanced Alarm Management (AAM) Integration Reference Point (IRP): Information Service 

(IS). 

32.123: Advanced Alarm Management (AAM) Integration Reference Point (IRP): Common Object 

Request Broker Architecture (CORB A) Solution Set. 

32.125: Advanced Alarm Management (AAM) Integration Reference Point (IRP): extensible Markup 

Language (XML) definitions. 

32.127: Advanced Alarm Management (AAM) Integration Reference Point (IRP): SOAP Solution 

Set (SS). 

The Itf-N interface is built up by a number of IRPs and a related Name Convention, which realise the functional 
capabilities over this interface. The basic structure of the IRPs is defined in 3GPP TS 32.150 [1]. 

A single network fault may generate a large number of alarms over space and time. In a large and complex network, 
simultaneous network faults may occur, causing the network operator to be flooded with high volume of alarms. The 
high volume of alarms, typically the one received by an IRPManager via the getAlarmList or alarm notifications of 
Alarm IRP specification, greatly inhibits the operator ability to quickly identify and locate the responsible network 
faults. Advanced Alarm Management IRP is intended to provide methods to improve this situation. 
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Scope 



The present specifies the SOAP Solution Set for the IRP whose semantics are specified in the Advanced Alarm 
Management (AAM) IRP Information Service (3GPP TS 32.122 [3]). 

This Solution Set specification is related to TS 32.122 v9.0.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

- References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

- For a specific reference, subsequent revisions do not apply. 

- For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TR 21.905: "Vocabulary for 3GPP Specifications". 

[2] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[3] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[4] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 

and definitions". 

[5] 3GPP TS 32.122: "Telecommunication management; Advanced Alarm Management (AAM) 

Integrations Reference Point (IRP); Information Service (IS)". 

[6] 3GPP TS 32.125: "Telecommunication management; Advanced Alarm Management (AAM) 

Integrations Reference Point (IRP); extensible Markup Language (XML) file format definition". 

[7] W3C SOAP 1 . 1 specification ( http://www.w3.org/TR/2000/NOTE-SOAP-20000508/) 

[8] W3C XPath 1 .0 specification ( http://www.w3.org/TR/1999/REC-xpath-19991 1 16) 

[9] W3C WSDL 1 . 1 specification ( http ://www. w3 .org/TR/200 1/NOTE- wsdl-200 10315) 

[10] W3C SOAP 1.2 specification ( http://www.w3.org/TR/soapl2-partl/) 

[II] 3GPP TS 32.307: "Telecommunication management; Configuration Management (CM); 
Notification Integration Reference Point (IRP): SOAP solution set". 

[12] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information Service (IS)" 
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3 Definitions, symbols and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TR 21.905 [1], 3GPP TS 32.101 [2], 
3GPP TS 32.102 [3], 3GPP TS 32.150 [4] apply. A term defined in the present document takes precedence over the 
definition of the same term, if any, in TR 21.905 [1]. 

Alike Alarm: Two alarms are considered alike, if the corresponding alarm notifications are issued by the same object 
instance with the same alarmType, same perceivedSe verity, same probableCause and same specificProblem (if present). 

Lower Edge of Time Window: The point in time which determines the begin of a time span. 

Upper Edge of Time Window: The point in time which determines the end of a time span. 

3.2 Abbreviations 

For the purposes of the present document, the abbreviations given in TR 21.905 [1], in 3GPP TS 32.101 [2], 

3 GPP TS 32.102 [3], 3 GPP TS 32.150 [4], and the following apply. An abbreviation defined in the present document 

takes precedence over the definition of the same abbreviation, if any, in TR 21.905 [1]. 

AAM Advanced Alarm Management 

AAMRule Advanced Alarm Management Rule 

4 Architectural features 
4.1 General 

The overall architectural feature of the Advanced Alarm Management IRP is specified in 3GPP TS 32.122 [4]. This 
clause specifies features that are specific to the SOAP solution set. 

The SOAP 1.1 specification [7] and WSDL 1.1 specification [9] are supported. 

The SOAP 1.2 specification [10] is supported optionally. 

This specification uses "document" style in WSDL file. 

This specification uses "literal" encoding style in WSDL file. 

The filter language used in the SS is the XPath Language (see W3C XPath 1.0 specification [8]). IRP Agents may throw 
a FilterComplexity Limit fault when a given filter is too complex. 

Relevant definitions are imported from the Advanced Alarm Management IRP XML definitions of 3GPP TS 32.125 
[6]. 

This specification uses a number of namespace prefixes throughout that are listed in Table 4.1. 1. 
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Table 4.1-1 : Prefixes and Namespaces used in this specification 



PREFIX 


NAMESPACE 


(no prefix) 


http://schemas.xmlsoap.org/wsdl/ 


soap 


http://schemas.xmlsoap.org/wsdl/soap/ 


aamRPSystem 


http://www.3gpp.org/ftp/Specs/archive/32 series/32.1 27#AAI\/IRPSystem 


aamlRPData 


http://www.3gpp.org/ftp/Specs/archive/32 series/32.1 27#AAI\/IIRP Data 


aam 


http://www.3gpp.Org/ftp/specs/archive/32_series/32.125#aamlRP 


xn 


http://www.3gpp.org/ftp/specs/archive/32 series/32. 625#genericNrm 


genericlRPSystem 


http://www.3gpp.org/ftp/Specs/archive/32_series/32.317/schema/32317/GenericlRPSystem 


ntflRPNtf System 


http://www.3gpp.org/ftp/Specs/archive/32_series/32.307/schema/32307/ 
notification/NotificationlRPNtfSystem 





5 Mapping 

5.1 Operation and notification mapping 

The Advanced Alarm Management IRP IS (3GPP TS 32.122 [5]) defines semantics of operation and notification visible 
across the Itf-N. Table 5.1.1 indicates mapping of these operations and notifications to their equivalents defined in this 
SS. 

Table 5.1.1 : Mapping from IS Operation to SS Equivalents 



IS Operations in 3GPP TS 32.122 [5] 


SS Operations 


Qualifier 


activateAAIVIRule 


activateAAIVIRule 


M 


getAAIVIRules 


getAAMRules 


M 


deactivateAAIVIRule 


deactivateAAMRule 


M 


getlRPVersion (note 1) 


getlRPVersion 


M 


getOperationProfile (note 1) 


getOperationProfile 





getNotificationProfile (note 1) 


getNotificationProfile 





NOTE 1 : These 3 operations are operations of IVIanagedGenericIRP IOC specified in 3GPP TS 32.312 [12]. 
The AdvancedAlarmManagementIRP IOC of 3GPP TS 32.122 [5] inherits from it. 



5.2 Operation parameter mapping 



The Advanced Alarm Management IRP IS (3GPP TS 32.122 [5]) defines semantics of parameters carried in the 
operations. The tables below show the mapping of these parameters, as per operation, to their equivalents defined in this 
SS. 

Table 5.2.1 : Mapping from IS activateAAMRule parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


aAMRuleType 


aAMRuleType 


M 


aAMRuleParameterList 


aAMRuleParameterList 


M 


filter 


filter 


M 


aAMRuleldentifier 


aAMRuleldentifier 


M 


status 


status 


M 



Table 5.2.2: Mapping from IS getAAMRules parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


aAMRuleList 


aAMRuleList 


M 


status 


status 


M 



ETSI 



3GPP TS 32.127 version 9.0.0 Release 9 



ETSI TS 132 127 V9.0.0 (2010-02) 



Table 5.2.3: Mapping from IS deactivateAAMRule parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


advancedAlarmManagementRuleldentifier advancedAlarmManagementRuleldentifier 


M 


status 


status 


M 



5.3 Notification parameter mapping 

The Advance Alarm Management IRP IS (3GPP TS 32.122 [5]) does not currently define any notifications. 
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Annex A (normative): 
WSDL specifications 



<?xml version="l . 0" encoding="UTF-8" ?> 
< ! -- 

3GPP TS 32.127 Advanced Alarm Management (AAM) IRP SOAP Solution Set 
- - > 

<def initions xmlns="http: //schemas .xmlsoap.org/wsdl/" 
xmlns : soap="http: //schemas .xmlsoap.org/wsdl/soap/" 

xmlns : aamIRPSystem= "http : //www . 3gpp . org/f tp/Specs/archive/32_series/32 . 12 7#AAMIRPSystem" 
xmlns : aamIRPData= "http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 12 7#AAMIRPData" 
xmlns :xaa="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 125#aamIRPIOCs" 

xmlns :genericIRPSystem="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 317/schema/32317- 
90 0/GenericIRPSystem" 

targetNamespace="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 12 7#AAMIRPSystem" > 
location="http: //www. 3gpp.org/ftp/Specs/archive/32_series/32 . 3 07/schema/323 07-90 0-wsdl . zip"/> 

<import namespace="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 317/schema/32317- 
900/GenericIRPSystem" location="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 317/schema/32317- 
900-wsdl . zip"/> 
<types> 

<schema targetNamespace="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 12 7#AAMIRPData" 
xmlns=" http://www.w3 . org/2 l/XMLSchema" > 

<import namespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 125#aamIRPIOCs"/> 
<!-- The following types are defined for the AAM IRP operations --> 
<complexType name="AdvancedAlarmRule" > 
<sequence> 

<element name="AdvancedAlarmRuleIdentif ier" type="xaa : AdvancedAlarmRuleldentif ier"/> 
< element name= " AdvancedAlarmRuleType " type= "xaa : AdvancedAlarmRuleType " / > 
<element name= " AdvancedAlarmRuleParameterList " 
type="xaa :AdvancedAlarmRuleParameterList "/> 

<element name="Filter" type="xaa : Filter"/> 
</sequence > 
</complexType> 

<complexType name= " AdvancedAlarmRuleList " > 
<sequence> 

<element name= " AdvancedAlarmRule " type= " aamlRPData : AdvancedAlarmRule " 
maxOccurs= " unbounded " / > 
</sequence > 
</complexType> 
<simpleType name= " Status " > 

<restriction base="string" > 

<enumeration value=" Success "/> 
<enumeration value="AAMRuleAlreadyActive"/> 
< enumeration value= "Spec if iedRuleNotExi sting" /> 
<enumeration value=" Failure" /> 
< /restrict ion> 
</simpleType> 

<!-- activateAAMRule Request- -> 
<element name =" activateAAMRule" > 
<complexType> 
<sequence> 

<element name= " advancedAlarmManagementRuleType " 
type= "xaa : AdvancedAlarmManagementRuleType " / > 

<element name="advancedAlarmManagementRuleParameterList " 
type="xaa :AdvancedAlarmManagementParameterList "/> 

<element name=" filter" type= "xaa : Filter" /> 
</sequence> 
</complexType> 
</element> 

<!-- activateAAMRule Response --> 
<element name="activateAAMRuleResponse" > 
<complexType> 
<sequence> 

<element name="advancedAlarmManagementRuleIdentif ier" 
type= "xaa : AdvancedAlarmManagementRuleldentif ier" /> 

<element name=" status" type= "aamlRPData : Status "/> 
</sequence> 
</complexType> 
</element> 

<!-- activateAAMRule Fault --> 
<element name="activateAAMRuleFault " > 
<simpleType> 

<restriction base="string" > 

<enumerat ion value= " OPERATION_FAILED " / > 
< /restrict ion> 
</simpleType> 
</element> 

<!-- getAAMRules Request- -> 
<element name= " getAAMRules " > 
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<!-- no input parameter --> 
<complexType> 
<sequence> 

<element name= "dummy" type=" string" minOccurs=" 0"/> 
</sequence> 
</complexType> 
</element> 

<!-- getAAMRules Response --> 
<element name="getAAMRulesResponse" > 
<complexType> 
<sequence> 

<element name="advancedAlarmRuleList " type="aamIRPData : AdvancedAlarmRuleList "/> 
<element name=" status" type="aamIRPData : Status "/> 
</sequence> 
</complexType> 
</element> 

<!-- getAAMRules Fault --> 
<element name= "getAAMRulesFault " > 
<simpleType> 

<restriction base="string" > 

<enumerat ion value= " OPERATION_FAILED " / > 
< /restrict ion> 
</simpleType> 
</element> 

<!-- deactivateAAMRule Request- -> 
<element name= "deactivateAAMRule" > 
<complexType> 
<sequence> 

<element name="advancedAlarmManagementRuleIdentif ier" 
type="xaa : AdvancedAlarmManagementRuleldentif ier"/> 
</sequence> 
</complexType> 
</element> 

<!-- deactivateAAMRule Response --> 
<element name="deactivateAAMRuleResponse" > 
<complexType> 
<sequence> 

<element name="status" type="aamIRPData : Status"/> 
</sequence> 
</complexType> 
</element> 

<!-- deactivateAAMRule Fault --> 
<element name="deactivateAAMRuleFault " > 
<simpleType> 

<restriction base="string" > 

<enumerat ion value= " OPERATION_FAILED " / > 
< /restrict ion> 
</simpleType> 
</element> 
</schema> 
</types> 
<message name="activateAAMRule" > 

<part name= "parameter" element="aamIRPData : activateAAMRule"/> 
</message> 
<message name= 
<part name= 
</message> 
<message name=" 

<part name= 
</message> 
<message name= 

<part name=" 
</message> 
<message name= 
<part name= 
</message> 
<message name=" 
<part name=" 
</message> 
<message name= 
<part name= 
</message> 
<message name=" 
<part name=" 
</message> 
<message name= 

<part name=" 
</message> 
<portType name= " AAMIRPPortType " > 

<operation name="activateAAMRule" > 

<input message="aamIRPSystem: activateAAMRule"/> 
<output message= " aamlRPSystem : act ivateAAMRuleResponse " / > 

< fault name= " act ivateAAMRuleFault " message= " aamlRPSystem : act ivateAAMRuleFault " / > 
</operation> 
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parameter" element="aamIRPData : activateAAMRuleResponse"/> 

activateAAMRuleFault " > 

parameter" element = "aamlRPData : activateAAMRuleFault " /> 

getAAMRules "> 

parameter" element=" aamlRPData : getAAMRules "/> 

getAAMRulesResponse " > 

parameter " element = " aamlRPData : getAAMRulesResponse " / > 

getAAMRulesFault " > 

parameter" element = " aamlRPData : getAAMRulesFault " / > 

deactivateAAMRuleRules" > 

parameter" element= "aamlRPData : deactivateAAMRule "/> 

deactivateAAMRuleResponse"> 

parameter" element= "aamlRPData rdeactivateAAMRuleResponse"/:; 

deactivateAAMRuleFault " > 

parameter" element= " aamlRPData : deactivateAAMRule "/> 
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<operation name="getAAMRules" > 

< input message="aamIRPSystem:getAAMRules"/> 
<output message= " aamlRPSystem : getAAMRulesResponse " / > 

< fault name= "getAAMRules Fault " message= " aamlRPSystem : getAAMRulesFault " / > 
</operation> 
<operation name= "deactivateAAMRule" > 

< input message=" aamlRPSystem: deactivateAAMRule "/> 
< output message= " aamlRPSystem : deact ivateAAMRuleResponse " / > 

< fault name="deactivateAAMRuleFault" message= " aamlRPSystem rdeacti vat eAAMRuleFault"/> 
</operation> 
< /port Type > 
<binding name= " AAMIRPBinding " type= " aamlRPSystem : AAMIRPPortType " > 

<soap : binding style= "document " transport= "http : //schemas . xmlsoap . org/soap/http" /> 
<operation name="activateAAMRule" > 
<soap : operation 
soapAction="http: //www. 3gpp.org/ftp/Specs/archive/32_series/32 . 12 7#activateAAMRule" 
style= " document " / > 
< input > 

<soap:body use=" literal "/> 
</ input > 
<output> 

<soap:body use=" literal "/> 
</output> 
<fault name="activateAAMRuleFault"> 

<soap: fault name="activateAAMRuleFault" use=" literal "/> 
</fault> 
</operation> 

<operation name= " getAAMRules " > 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 12 7#getAAMRules" style= "document "/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
</output> 
<fault name= "getAAMRulesFault "> 

<soap: fault name= "getAAMRulesFault" use=" literal "/> 
</fault> 
</operation> 

<operation name= "deactivateAAMRule" > 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 12 7#deactivateAAMRule" 
style= " document " / > 
< input > 

<soap:body use=" literal "/> 
</ input > 
<output> 

<soap:body use=" literal "/> 
</output> 
<f ault name= " deact ivateAAMRuleFault" > 

<soap: fault name=" deact ivateAAMRuleFault" use=" literal "/> 
</fault> 
</operation> 
</binding> 
<service name="AAMIRPService" > 

<port name="AAMIRPPort" binding= "aamlRPSystem: AAMIRPBinding" > 

<soap : address location="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 127#AAMIRP"/> 
</port> 

<port name= "GenericIRPPort " binding= "genericIRPSystem : GenericIRPBinding" > 
<soap: address 
location="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 317#GenericIRP"/> 
</port> 
</service> 
</def initions> 
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